        SERIES 3 PRINTER DRIVERS and SUPPORT FOR RICH TEXT FORMAT 
        =========================================================

PRINTER DRIVERS FOR THE SERIES 3
--------------------------------

The WDR directory/folder contains printer drivers and associated files,
which can be copied to a \WDR\ directory on any disk on your Series
3. The next time you then use a `Print setup' option, you will find
the extra printers offered in the dialog.

HP2.WDR - printer driver for the Hewlett Packard Laserjet II.

HP2P.WDR - printer driver for the Hewlett Packard Laserjet IIP/IID.

HP3.WDR - printer driver for the Hewlett Packard Laserjet III.

PS.WDR, PS.INI, PS.DYL - printer driver (and other necessary files)
which supports a basic set of fonts for any Postscript printer.

PSAPPLE.WDR, PSAPPLE.INI, PSAPPLE.DYL - printer driver (and other
necessary files) for the Apple Laserwriter II series. These support a
wider range of fonts than the other Postscript drivers. You may find
that you can use these files to drive many other Postscript printers
that also have a wider range of fonts.


RICH TEXT FORMAT (RTF) SUPPORT FOR THE SERIES 3 WORD PROCESSOR
--------------------------------------------------------------

The Series 3 Word Processor can save and load files in Microsoft Rich Text
Format (RTF) for interchanging documents with other programs which can save
and load RTF files, such as:

  -   Microsoft Word for Windows
  -   Microsoft DOS Word
  -   Microsoft Word on the Macintosh


Installation
------------

Before you can save and open RTF files on your Series 3 you must copy the
WL$RTF.DYL and WS$RTF.DYL files supplied in the same location on the 3 Link
disk as this document. The files must be copied to a \WDR\ directory on the
Series 3. You can use the Internal disk or, if you want to avoid using up
internal memory, an SSD in drive A or B.

(Don't confuse the \WRD and \WDR directories - while \WRD\ is the directory
where Word Processor documents are stored, \WDR is where the Word Processor
keeps special files of various kinds - templates, and add-on software or
printer drivers. WL$RTF.DYL has the software to open RTF files, and
WS$RTF.DYL the software to save them - you don't have to copy both.)

  ->  Press the System button, to return to the System screen, and select the
`Copy file' option on the `File' menu.

  ->  Move the highlight to the `To file: Name' line. Type \WDR\.

  ->  If you want to copy the files to an SSD, move the highlight to the
`To file: Disk' line, and change it to `A' or `B' accordingly.

  ->  Move the highlight to the `From file: Disk' line, and change it to the
drive containing MCLINK. On a PC this will be something like REM::A or
REM::C. On a Macintosh, it will be REM:: plus the name of the disk -
REM::HD40 for example.

  ->  Move the highlight to the `From file: Name' line. The simplest way to
select the files is to press Control-Tab. Then type W*.DYL, but with the
directory/folder name they are in - for example, if you're copying them from
the supplied floppy, use \WDR\W*.DYL (WDR:W*.DYL on a Macintosh). Finally,
press Control-Enter, which selects these as the files to copy.

(Alternatively, you can press Tab to bring up the file selector, and navigate
to the directory concerned. You might then copy the files one by one, or tag
them both with the `+' key and copy them together.)

  ->  Press Enter, and the Series 3 will copy the files.

You can copy RTF files to and from the Series 3 like any other files, as
described in the 3 Link manual. When you next use the `Open file' or
`Save as' options in the Word Processor, you will now be able to set the
`File type' line to 'Rtf', and select an RTF file.

Note: when the file is next saved - and this will happen if you switch
to a different file - it will be saved in Word Processor format,
complete with style and emphasis information. The .WRD file extension
will be used. If at some point you want to send the file back to the
PC or Macintosh, use the `Save as' option and make a new RTF version
of the file.


Direct access to remote RTF files
---------------------------------

You can use the `Open file' and `Save as' options directly on RTF
files on a PC or Macintosh, as long as the Series 3 is linked by
MCLINK. Select the file on REM::. See the 3 Link manual for more
details.


Using the HP3 printer driver as a nominal RTF driver
----------------------------------------------------

An RTF file contains a description of the fonts used in the document 
from which it was created. The fonts available when writing a 
document depend on the currently installed printer driver.

An RTF reader attempts to reproduce each of these fonts, by finding 
the closest match with one of the fonts supplied by its own currently
installed printer driver.

The accuracy of transfer of font styles thus depends on the installed
printer drivers at both ends of the transfer. In the worst case, if 
there is no match between the fonts supported at either end of the 
transfer, all fonts will be converted by the receiver to a default 12
point monospaced font.

The HP3 printer driver (with file name HP3.WDR - also supplied on
this disk) is primarily for printing to the Hewlett Packard III laser
printer. However, with RTF, it is worth using HP3.WDR as driver even
when there is no prospect of printing to the intended printer because
it contains a good basic font set - mono-spaced Courier, a scalable
serif font and a scalable sans-serif font which travel well through
the "RTF barrier". Using this printer driver on the Series 3 means
that:

    on exporting an RTF file from the Series 3, the fonts will be
    ones that have a good chance of being matched by the ones
    supported by a receiver

    on importing an RTF file to the Series 3, there is a good range
    of font styles available for matching with the incoming fonts.

If you are a Macintosh Word user printing to a Postscript laser printer, you
may be pleasantly surprised at the possibilities when using the HP3 driver on
the Series 3.

To install the HP3 driver, you copy HP3.WDR to a \WDR\ directory on the 
Series 3 - as for WL$RTF.DYL and WS$RTF.DYL, described above.

Restrictions on headers and footers
-----------------------------------

The Word Processor supports only one header, which applies to the whole
document. If an RTF file specifies some other type of header, such as for
even pages only, this may become the header for the whole document.

The `On first page' settings in the Word Processor's `Header' and `Footer'
dialogs are not affected by opening an RTF file.

If a header in Microsoft Word has a separate stylesheet size, or any changes
of font within its text, these will be ignored. 

Microsoft Word may not support the %F and %M codes, nor two- and
three-column headers, which will be treated as left-justified.

The same restrictions apply to footers as to headers.

Other limitations
-----------------

USE A .RTF FILE EXTENSION FOR ALL RTF FILES - ON THE SERIES 3, PC AND
MACINTOSH. When you save an RTF file, the Word Processor forces this
extension, but you should also use this file extension when creating RTF
files on a PC or Macintosh word processor. (On a Macintosh, this means that
filenames of RTF files should end with a dot, followed by the three
characters R T F ).

Content which is beyond that handled by the Series 3 word processor (such as
boxes, graphics, side-by-side formatting of paragraphs and tables of contents
entries) are not transferred into Series 3 Word documents.


Using Stylesheets in Microsoft DOS Word
---------------------------------------

(This information is based on version 5.0 of the MS-DOS version of
Microsoft Word.)

Microsoft Word for DOS saves a document's style information in a separate
file - a stylesheet. It can also, however, handle files without a stylesheet,
using in-line formatting - storing special codes in the document which
specify the various settings for each paragraph.

If you use a stylesheet with a particular Microsoft Word file, and you want
to transfer the file to and from the Series 3, do not change any of the
styles while on the Series 3. (You can still apply styles to paragraphs, and
you can use emphases as normal.) When you next send the file to the PC and
use it in Microsoft Word, it will ask for the stylesheet to use. Microsoft
Word checks that the document styles still match the stylesheet. Any
paragraphs which have a style that does not match those in the stylesheet are
converted to use in-line formatting.

If you are a user of the `Alter paragraph' option (instead of the
`Styles' option) for changing the look of paragraphs, this should not
worry you.


Control over fonts with Microsoft DOS Word
------------------------------------------

Microsoft Word for DOS does is not as sophisticated in its mapping of
incoming fonts when it reads an RTF file as is Microsoft Word for Windows or
Microsoft Word for the Macintosh. When you load an RTF document using
Microsoft Word for DOS (having created it on your Series 3), you may find
that some fonts have been mapped to those which are not present in the
current printer driver (in which case, they will be printed as Courier).

For greater control over the fonts DOS Microsoft Word uses, you have
two options:

  1)  To simply use in-line formatting to change the fonts.

  2)  Use an approach involving two separate stylesheets.

The first is simpler to understand but the second solution, once in place,
has the advantage of automatically applying to all files that you
subsequently transfer from the Series 3 into DOS Microsoft Word.

The steps involved in this second approach are as follows:

  ->  Choose a representative document, written on the Series 3, that
includes all the styles you use on a regular basis

  ->  Save this as an RTF file

  ->  On loading it into Microsoft Word, leave the stylesheet selection blank
(delete any suggestion offered to you)

  ->  You will probably find it easier in what follows to make the style bar
visible (use Options)

  ->  For each style that you want to record, place the cursor in some text
with that style

  ->  Use Format Stylesheet Record (alternatively, Alt-F10)

  ->  Give as the Key Code the shortcode used on the Series 3 for the style

  ->  Leave Usage as Paragraph and type anything you like into Remark
(leave it blank if you wish)

  ->  For Variant, in most cases you can accept the default offered to
you, but match `Standard' to `Body Text', and `Heading level' styles
to the appropriate Series 3 `Header level' style (especially if you
use outlining).

  ->  Repeat for all the styles you are interested in

  ->  When finished, save the resulting stylesheet (use Gallery Transfer
Save), with a name such as "S3"

  ->  Then in Gallery, look at the fonts specified by each style, and make
any changes required

  ->  Save the stylesheet you have at the end of this second pass WITH A
DIFFERENT NAME, say "S3P" (with the "P" standing for "Printing").

From now on, whenever you load an RTF file prepared by the Series 3 into
DOS Microsoft Word, all you need to do is:

  ->  When prompted for the name of a stylesheet, give "S3" (or whatever you
named the first of the two stylesheets)

  ->  Once the load has completed, use Format Stylesheet Attach to attach the
second stylesheet, "S3P" or whatever, instead.

Use of BOTH stylesheets is essential to the operation of the scheme.

The system takes some effort to set up but you will be amply rewarded with
its power and ease of use in the long run.


ADVANCED RTF FONT AND STYLE TRANSFER
------------------------------------

You can more accurately control the way that fonts and style names
are transferred in RTF by using an RTF map file, which is a plain
text file, with the name 'rtfmap.txt', in any \WDR subdirectory of
the root directory of a local drive (the drive search order is
M:, A:, B:). 

The contents of a typical map file could be:

:STYLES
 BT      9       Normal;
 HA      1       heading 1;
 HB      2       heading 2; 
:FONTS
 00      fmodern;        pica;
 24      froman;         Times New Roman;

The keywords :STYLES and :FONTS introduce style and font mappings
respectively. They may occur in any order and may be repeated.

Whitespace before an item is generally ignored, as is any text
following the final semicolon (;). Long labels are truncated to 15
(style labels) or 19 (font names) characters, not counting the
terminating semicolon. Illegal entries are ignored, without
generating any error notification.

Style mapping

Each line represents the correspondence between the shortcode,
outline level and a style label. The style labels should correspond
with those used by Microsoft Word (or any other word processor that
understands the RTF format). You can determine these names from the
stylesheet section of an RTF file generated by the word processor
(see the later 'RTF files' section).

There is no checking for duplicate shortcodes or labels, so be
warned. Total duplicates are wasteful of memory but otherwise
harmless. Pairs of entries that match in either their shortcode or
their label, but not both, should be avoided.

To prevent any possibility of error in bi-directional mapping, one-
or two-character labels (particularly if they start with X, Y or Z)
should be avoided.

Font mapping

Each line represents the correspondence between a font ID, the RTF
font class and a font name.

The font IDs should be unique and must lie in the range 0 to 63
inclusive. The font IDs used by the Psion word processor vary from
printer to printer. You can find which font IDs are used in a
particular printer driver by examining the font table in an RTF file
that was saved from the Psion word processor with that printer driver
installed, and with no font mapping (see the later 'RTF files'
section).

There is no harm in mapping a font to an ID that is not supported by
a particular printer driver, but it will be displayed and printed in
the printer's default (monospaced) font. The following table
indicates the preferred general allocation scheme for font IDs used
in Psion printer drivers:

  0 COURIER            22 OPTIONAL_SB          44 RUSSIAN
  1 PICA               23 OPTIONAL_SC          45 OPTIONAL_B
  2 ELITE              24 TIMES_ROMAN          46 OPTIONAL_C
  3 PRESTIGE           25 CENTURY              47 OPTIONAL_D
  4 LETTER_GOTHIC      26 PALATINO             48 NARRATOR
  5 GOTHIC             27 SOUVENIR             49 EMPHASIS
  6 CUBIC              28 GARAMOND             50 ZAPF_CHANCERY
  7 LINEPRINTER        29 CALEDONIA            51 OPTIONAL_DA
  8 HELVETICA          30 BODONI               52 OLD_ENGLISH
  9 AVANT_GARDE        31 UNIVERSITY           53 OPTIONAL_DB
  10 SPARTAN           32 SCRIPT               54 OPTIONAL_DC
  11 METRO             33 SCRIPT_PS            55 COOPER_BLACK
  12 PRESENTATION      34 OPTIONAL_SCA         56 SYMBOL
  13 APL               35 OPTIONAL_SCB         57 LINE_DRAW
  14 OCR_A             36 COMMERCIAL_SCRIPT    58 MATH_7
  15 OCR_B             37 PARK_AVENUE          59 MATH_8
  16 STANDARD_ROMAN    38 CORONET              60 DINGBATS
  17 EMPEROR           39 OPTIONAL_SCC         61 EAN
  18 MADELEINE         40 GREEK                62 PC_LINE
  19 ZAPF_HUMANIST     41 KANA                 63 OPTIONAL_SYA
  20 CLASSIC           42 HEBREW
  21 OPTIONAL_SA       43 OPTIONAL_A

The RTF font class must be one of:
     fnil            Unknown or default
     froman          Roman; proportional serif
     fswiss          Swiss; proportional sans serif
     fmodern         Monospaced serif and sans serif
     fscript         Script
     fdecor          Decorative
     ftech           Technical, symbol and mathematical

The font names should be those present in the font table of a
Microsoft Word (or other word processor) RTF file and do not need to
match the names of Psion printer driver fonts.

Open (RTF)

If a map file is located, and contains valid style entries, the list
is scanned for a match with an incoming label and, if found, the
style is given the corresponding shortcode and outline level. This
style will overwrite any existing style with the same shortcode.

Styles with non-matching labels have their style labels preserved.
They are given an outline level of 9 and a shortcode consisting of
the first two letters of the label (a preceding X is added if the
label contains only one character). If this shortcode is illegal or
matches an existing style, a unique shortcode is generated. These
styles, therefore, never overwrite existing styles.

If there are no valid style map entries, incoming style labels
"Normal" and "heading n" (1 <= n <= 8) are handled explicitly,
generating shortcodes of BT, and HA to HH, with outline levels of 9
for BT and 1 to 8 for the headings. These styles always overwrite any
existing style of the same shortcode.


All incoming fonts whose names match an entry in the map file are
allocated the corresponding ID, regardless of whether this is
supported by the current printer driver.

Non-matching incoming fonts are converted to those supported by the
current printer driver. Fonts are preserved only if they are an exact
match, by both name and RTF font family (the Psion word processor
currently only supports fonts in the fmodern, fswiss and froman
families - see above). Otherwise an attempt is made to convert the
font to a supported font in the same family. If this is not possible,
the font is converted to the current default (monospaced) font.

Save as (RTF)

If a map file is located, and contains valid entries, the list is
scanned for a match with an outgoing shortcode and, if found, the
style is given the corresponding label. Styles with non-matching
shortcodes are given labels equal to their shortcodes, irrespective
of the text of their current labels.

If there are no style map entries, the first style of outline level 9
to be saved (usually BT) is saved with the label "Normal". Similarly,
the first styles of outline level 1 to 5 (usually HA etc.) are saved
with labels from "heading 1" to "heading 5". All other styles are
saved with labels consisting of their shortcodes, irrespective of the
text of their current labels.

The font table includes all fonts listed in the map file, together
with any additional fonts supported by the current printer driver
(provided their font IDs do not match with IDs present in the map
file).

In the absence of any font mappings, only those fonts supported by
the current printer driver are included in the RTF file.

RTF files

An RTF file is a plain text file containing the text of a document,
together with plain text encoding of style and formatting
information.

A Psion map file affects the content of the RTF file font table and
stylesheet sections which can be found near the beginning of the RTF
file.

The font table contains a list of font entries, enclosed by:

        { \fonttbl                      }

Each font entry consists of a font number (ID), a font family and a
font name, for example:

        { \f0  \fmodern  pica; }

The stylesheet section contains a list of stylesheet entries,
enclosed by:

        {  \stylesheet                  }

Each stylesheet entry consists of a variety of style instructions,
terminated by the style label, for example:

        { \s244 \li270 \f3 \fs20 \ul heading 4; }

In this example the label is "heading 4".
